/**
 * 安全格式化 JSON 字符串，始终返回字符串结果
 * @param value 需要格式化的输入字符串
 * @returns 格式化后的 JSON 字符串或原始字符串（带错误标记）
 */
export const formatJson = (value: string): string => {
  const safeValue = value?.trim() || ''

  if (!safeValue) return ''

  try {
    const parsedValue = JSON.parse(safeValue)
    return JSON.stringify(parsedValue, null, 4)
  } catch (error) {
    console.error('[formatJson] 格式化失败:', error)
    return `/* Invalid JSON: ${(error as Error).message} */\n${safeValue}`
  }
}
